Inside Macintosh: Macintosh Toolbox Essentials
Previous | Chapter Top | Chapter Contents | Next |
You should never access low-memory globals directly. Instead, use a high-level Window Manager function, if one is available. If a high-level function is not available, you can use one of the accessors described here.
Sets the handle used by the Window Manager to identify the first auxiliary window record in the auxiliary window list.
pascal void LMSetAuxWinHead (AuxWinHandle value);
The Window Manager creates and maintains the information in auxiliary window records. Your application seldom, if ever needs to access the auxiliary window list.
The LMSetAuxWinHead function sets the value of the low-memory global AuxWinHead , which contains a handle to the address interpreted by the Window Manager as the first auxiliary window record in the auxiliary window list.
For a description of the auxiliary window record, see "The Auxiliary Window Record" . To get a handle to an window's auxiliary window record, use the GetAuxWin function (GetAuxWin) . To get a handle to the first auxiliary window record in the auxiliary window list, use LMGetAuxWinHead (LMGetAuxWinHead) .
Gets the handle used by the Window Manager to identify the first auxiliary window record in the auxiliary window list.
pascal AuxWinHandle LMGetAuxWinHead (void);
The Window Manager creates and maintains the information in auxiliary window records. Your application seldom, if ever needs to access the auxiliary window list.
The LMSetAuxWinHead function returns the value of the low-memory global AuxWinHead , which contains a handle to the address interpreted by the Window Manager as the first auxiliary window record in the auxiliary window list.
For a description of the auxiliary window record, see "The Auxiliary Window Record" . To get a handle to an window's auxiliary window record, use the GetAuxWin function (GetAuxWin) . To set a handle to the first auxiliary window record in the auxiliary window list, use LMSetAuxWinHead (LMSetAuxWinHead) .
Sets the procedure called by the Window Manager to paint the desktop.
pascal void LMSetDeskHook (UniversalProcPtr value);
The LMSetDeskHook function sets the value of the low-memory global DeskHook , which contains a pointer to the procedure used by the Window Manager as the desk hook function.
To get the optional procedure that the Window Manager calls to paint the desktop, use the LMGetDeskHook function (LMGetDeskHook) .
Gets the optional procedure called by the Window Manager to paint the desktop.
pascal UniversalProcPtr LMGetDeskHook (void);
The LMGetDeskHook function returns the value of the low-memory global DeskHook , which contains a pointer to the procedure used by the Window Manager as the desk hook function.
To set the optional procedure that the Window Manager calls to paint the desktop, use the LMSetDeskHook function (LMSetDeskHook) .
Sets the optional procedure called by the Window Manager during TrackGoAway (TrackGoAway) , TrackBox (TrackBox) , DragWindow (DragWindow) , GrowWindow (GrowWindow) , and DragGrayRgn (DragGrayRgn) functions.
pascal void LMSetDragHook (UniversalProcPtr value);
The LMSetDragHook function sets the value of the low-memory global DragHook , which contains a pointer to the procedure interpreted by the Window Manager as the drag hook function.
To get the optional drag hook procedure that the Window Manager calls, use the LMGetDragHook function (LMSetDeskHook) .
Gets the optional procedure called by the Window Manager during TrackGoAway (TrackGoAway) , TrackBox (TrackBox) , DragWindow (DragWindow) , GrowWindow (GrowWindow) , and DragGrayRgn (DragGrayRgn) functions.
pascal UniversalProcPtr LMGetDragHook (void);
The LMGetDragHook function returns the value of the low-memory global DragHook , which contains a pointer to the procedure used by the Window Manager as the drag hook function.
To set the optional drag hook procedure that the Window Manager calls, use the LMSetDragHook function (LMSetDragHook) .
Sets the pattern of the dragged region's outline.
pascal void LMSetDragPattern (const Pattern *dragPatternValue);
To get the pattern of the dragged region's outline, use LMGetDragPattern (LMGetDragPattern) .
Gets the pattern of the dragged region's outline.
pascal void LMGetDragPattern (Pattern *dragPatternValue);
To set the pattern of the dragged region's outline, use LMSetDragPattern (LMSetDragPattern) .
Sets the handle used by the Window Manager to identify the saved content region.
pascal void LMSetOldContent (RgnHandle value);
The LMSetOldContent function sets the value of the low-memory global OldContent , which the Window Manager interprets as a handle to the saved content region.
To get the handle used by the Window Manager to identify the saved content region, use the LMGetOldContent function (LMGetOldContent) .
Returns the handle used by the Window Manager to identify the saved content region.
pascal RgnHandle LMGetOldContent (void);
The LMGetOldContent function returns the value of the low-memory global OldContent , which the Window Manager interprets as a handle to the saved content region.
To set handle used by the Window Manager to identify the saved content region, use LMSetOldContent (LMSetOldContent) .
Sets the handle used by the Window Manager to identify the saved structure region.
pascal void LMSetOldStructure (RgnHandle value);
The LMSetOldStructure function sets the value of the low-memory global OldStructure , which the Window Manager interprets as a handle to the saved structure region.
To get handle used by the Window Manager to identify the saved structure region, use LMGetOldStructure (LMGetOldStructure) .
Sets the handle used by the Window Manager to identify the saved structure region.
pascal RgnHandle LMGetOldStructure (void);
The LMGetOldStructure function returns the value of the low-memory global OldStructure , which the Window Manager interprets as a handle to the saved structure region.
To set handle used by the Window Manager to identify the saved content region, use LMSetOldStructure (LMSetOldStructure) .
Sets the flag used by the Window Manager to determine whether to paint the window white before an update event.
pascal void LMSetPaintWhite (SInt16 value);
To get the flag used by the Window Manager to determine whether to paint the window white before an update event, use the LMGetPaintWhite function (LMGetPaintWhite) .
Returns the flag used by the Window Manager to determine whether to paint the window white before an update event.
pascal SInt16 LMGetPaintWhite ( void );
To set the flag used by the Window Manager to determine whether to paint the window white before an update event, use the LMSetPaintWhite function (LMSetPaintWhite) .
Sets the flag used by the Window Manager to determine whether to generate update events.
pascal void LMSetSaveUpdate (SInt16 value);
To get the flag used by the Window Manager to determine whether to generate update events, use the LMGetSaveUpdate function (LMGetSaveUpdate) .
Returns the flag used by the Window Manager to determine whether to generate update events.
pascal SInt16 LMGetSaveUpdate (void);
The LMGetSaveUpdate function sets the value of the low-memory global SaveUpdate , which the Window Manager uses to determine whether to generate update events.
To set the flag used by the Window Manager to determine whether to generate update event, use the LMSetSaveUpdate function (LMSetSaveUpdate) .
Sets the handle used by the Window Manger to identify the saved visible region.
pascal void LMSetSaveVisRgn (RgnHandle value);
The LMSetSaveVisRgn function sets the value of the low-memory global SaveVisRgn , which the Window Manager interprets as a handle to the saved visible region.
To get the handle used by the Window Manager to identify the saved visible region, use the LMGetSaveVisRgn function (LMGetSaveVisRgn) .
Returns the handle used by the Window Manger to identify the saved visible region.
pascal RgnHandle LMGetSaveVisRgn (void);
The LMGetSaveVisRgn function returns the value of the low-memory global SaveVisRgn , which the Window Manager interprets as a handle to the saved visible region.
To set the handle used by the Window Manager to identify the saved visible region, use the LMSetSaveVisRgn function (LMSetSaveVisRgn) .
Sets the pointer used by the Window Manager to identify the first window in the window list.
pascal void LMSetWindowList (WindowPtr value);
The LMSetWindowList function sets the value of the low-memory global WindowList , which the Window Manager interprets as a pointer to the first window in the window list.
To get the pointer used by the Window Manager to identify the first window in the window list, use the LMGetWindowList function (LMGetWindowList) .
Returns the pointer used by the Window Manager to identify the first window in the window list.
pascal WindowPtr LMGetWindowList (void);
The LMGetWindowList function returns the value of the low-memory global WindowList , which the Window Manager interprets as a pointer to the first window in the window list.
To set the pointer used by the Window Manager to identify the first window in the window list, use the LMSetWindowList function (LMSetWindowList) .